Registered License Dialog

Registering the license for TA is done from the TA Web Client.

You can verify your purchased licenses in the Registered License dialog displayed by selecting Activities > Registered License in the TA Web.

Master License Tab

This tab displays this information about the Master:

  • Company Name – Your company name. No company name displays if you have a demo license. The company name displayed here is used in all TA reports.

  • Master License for Machine – The licensed Master machine name.

  • Serial Number – The unique identification number of the Master machine.

  • Operating System – The operating system of the TA Master machine.

  • Database – The type of database (Oracle, Microsoft SQL, or PostgreSQL).

  • Expiration – The license’s expiration date. You may need to renew your license before the expiration date.

  • Options – Displays added purchased software options that complement TA (e.g. fault tolerance).

  • Connections – Contains the available connections associated with the license.

Licensed Agents Tab

The Licensed Agents tab displays information about the agents licensed to work with the Master.

Note: Only non-floating agents are displayed on the Licensed Agents tab. You can define your agents if your license has a floating agent provision, but the Licensed Agents tab displays no information.

This tab displays this information about the agents:

  • Agent – The machine name for the licensed agent.

  • Serial – The serial number of the licensed agent.

  • Floating – Specifies if the license is floating or not.

  • Operating System – The operating system type of the licensed agent. TA supports MVS, z/OS, OS/400, Windows, and Unix platforms.

  • Expiration – The license’s expiration date. You may need to renew your license before the expiration date.

  • Max Jobs – The maximum number of jobs you can run concurrently on the agent. You can configure a lower value for the agent from the Connections pane, but this value cannot exceed your licensed value.

  • Jobs – Displays the current count of jobs, tracking the number of jobs to enforce the license restriction on an agent, as shown in the Max Jobs column.

  • CPU – The number of CPUs on an agent machine. If the number of CPUs on a machine exceeds the authorized number, the Master turns off the agent connection and logs a licensing error. The licensing discrepancy must be resolved by contacting the Licensing Administrator for Tidal before the agent connection can be re-established.

    Note: Restart the Client Manager after a new license has been loaded.

Licensing Procedures for Demo and Permanent TA Licenses

The section provides the procedures for applying for a temporary demo TA license or a permanent TA license. Carefully follow the instructions in each section to ensure your license is applied correctly.

Applying a Demo License

To license TA with a Demo license:

  1. Click Queues > System Queue and set the value to 0. This will stop all jobs from launching. Wait until all running jobs are completed.

  2. Stop the TA Master. Stop the TA Master before you can load a license file. An error message will display if you attempt to load a license when the TA Master is still running.

    Windows:

    • Click Start and click Programs > Tidal Automation > Scheduler > Master > Service Control Manager.

    • Click Scheduler Master in the Service list and click Stop.

    Unix:

    • Enter tesm stop.

    • Take a backup and then remove all old license files (Example: *.lic and *.lic_old) from the <master installation directory>\config\ directory. By default, based on your platform, this directory is:

      Windows:

      C:\Program File\TIDAL\Scheduler\Master\config

      Unix:

      /opt/TIDAL/Scheduler/Master/config

  1. Create a new file called demo.lic in the <master installation directory>\config\ directory.

  1. Type or paste the contents of the license file into the new demo.lic file.

  1. Save the file in the <master installation directory>\config\ directory.

  1. Restart the Master: Windows:

    • Click Start in the Service Control Manager. Unix:

    • Enter tesm start.

The Master reads and applies the demo code when it starts.

Applying a Permanent License

Normally, you would want the TA license to register the host on which the TA Master would run. In case you wish to procure a TA license that registers a virtual host name instead of the hostname of the machine on which the TA Master would run, ensure that the prerequisites are met before you apply the permanent license:

  1. The virtual host machine must be configured to port forward to the host machine on which the TA Master runs. I.e., the virtual host should act as a front-ending proxy.

  1. The master.props must set these configuration parameter:

    VIRTUALHOSTVERIFICATIONPORT = <port-number>

    Where Port-number is any unused port on the host running the TA Master. The Master uses this port to accept an incoming TCP connection request, which is initiated by the Master process itself but is routed via the virtual host.

    The general process for applying a permanent license is detailed below.

To license TA with a Permanent license:

  1. Click Queues > System Queue and set the value to 0. This will stop all jobs from launching. Wait until all running jobs have been completed.

  2. Stop the Master:

    Windows:

    • Click Start and click Programs > Tidal Automation > Scheduler > Master > Service Control Manager.

    • Choose Scheduler Master in the Service list and click Stop.

    Unix:

    • Enter tesm stop.

    • Take a backup and remove all old license files (e.g., *.lic and *.lic_old) from the <master installation directory>\config\ directory.

      By default, based on your platform, this directory is:

    Windows: C:\Program Files\TIDAL\Scheduler\Master\config

    Unix: /opt/TIDAL/Scheduler/Master/config

  1. Create a new file called master.lic in the <master installation directory>\config\ directory.

  1. Type or paste the contents of the license file into the new master.lic file.

  1. Save the file in the <master installation directory>\config\ directory.

  2. Restart the Master. The Master reads and applies the master code when it starts.

    Windows: Click Start in the Service Control Manager.

    Unix: Enter tesm start.